package org.example.ai04.repository;

import org.example.ai04.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

import java.util.Optional;

/**
 * 用户数据访问接口
 * 提供对用户实体的CRUD操作和自定义查询方法
 * 继承自JpaRepository，自动获得基本的数据操作能力
 * 
 * Spring Data JPA特性：
 * - 方法命名查询：通过方法名自动生成SQL查询，无需手动编写
 * - 分页和排序支持：内置分页和排序功能
 * - 事务管理：默认在所有方法上应用事务
 * 
 * 在系统中主要用于：
 * - 用户注册时检查用户名和邮箱是否已存在
 * - 用户登录时根据用户名或邮箱查找用户信息
 * - 用户信息的增删改查操作
 */
@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    /**
     * 根据用户名查找用户
     * @param username 用户名
     * @return 包含用户的Optional对象，如果不存在则为空
     */
    Optional<User> findByUsername(String username);
    
    /**
     * 根据邮箱查找用户
     * @param email 电子邮箱
     * @return 包含用户的Optional对象，如果不存在则为空
     */
    Optional<User> findByEmail(String email);
    
    /**
     * 检查用户名是否已存在
     * @param username 用户名
     * @return 如果用户名已存在则返回true，否则返回false
     */
    boolean existsByUsername(String username);
    
    /**
     * 检查邮箱是否已存在
     * @param email 电子邮箱
     * @return 如果邮箱已存在则返回true，否则返回false
     */
    boolean existsByEmail(String email);
}